IRIX Base Documentation 1998 November

home *** CD-ROM | disk | FTP | other *** search

/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cato / Xm / XmDragContext.z / XmDragContext

Wrap

Text File | 1998-10-20 | 96KB | 1,321 lines

XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) NNNNAAAAMMMMEEEE XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt - The DragContext widget class SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////DDDDrrrraaaaggggDDDDrrrroooopppp....hhhh>>>> VVVVEEEERRRRSSSSIIIIOOOONNNN This page documents version 1.2 of the Motif library. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN DragContexts are special widgets used in drag and drop transactions. A DragContext is implemented as a widget, but a client does not explicitly create a DragContext widget. Instead, a client initiates a drag and drop transaction by calling XXXXmmmmDDDDrrrraaaaggggSSSSttttaaaarrrrtttt, and this routine initializes and returns a DragContext widget. There is a unique DragContext for each drag operation. The toolkit frees a DragContext when a transaction is complete; therefore, an application programmer should not explicitly destroy a DragContext. Initiator and receiver clients both use DragContexts to track the state of a transaction. When the initiator and receiver of a transaction are in the same client, they share the same DragContext instance. If they are in different clients, there are two separate DragContexts. In this case, the initiator calls XXXXmmmmDDDDrrrraaaaggggSSSSttttaaaarrrrtttt and the toolkit provides a DragContext for the receiver client. The only resources pertinent to the receiver are XXXXmmmmNNNNeeeexxxxppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss and XXXXmmmmNNNNnnnnuuuummmmEEEExxxxppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss. These can both be passed as arguments to the XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeeeRRRReeeettttrrrriiiieeeevvvveeee function to obtain information about the current drop site. In general, in order to receive data, a drop site must share at least one target type and operation in common with a drag source. The DragContext resource, XXXXmmmmNNNNeeeexxxxppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss, identifies the selection targets for the drag source. These export targets are compared with the XXXXmmmmNNNNiiiimmmmppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss resource list specified by a drop site. The DragContext resource, XXXXmmmmNNNNddddrrrraaaaggggOOOOppppeeeerrrraaaattttiiiioooonnnnssss, identifies the valid operations that can be applied to the source data by the initiator. The drop site counterpart resource is XXXXmmmmNNNNddddrrrrooooppppSSSSiiiitttteeeeOOOOppppeeeerrrraaaattttiiiioooonnnnssss, which indicates a drop site's supported operations. A client uses DragIcon widgets to define the drag-over animation effects associated with a given drag and drop transaction. An initiator specifies a set of drag icons, selects a blending model, and sets foreground and background cursor colors with DragContext resources. The type of drag-over visual used to represent a drag operation depends on the drag protocol style. In Page 1 (printed 4/30/98) XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) preregister mode, the server is grabbed, and either a cursor or a pixmap may be used as a drag-over visual. In dynamic mode, drag-over visuals must be implemented with the X cursor. If the resulting drag protocol style is Drop Only or None and the XXXXmmmmNNNNddddrrrraaaaggggIIIInnnniiiittttiiiiaaaattttoooorrrrPPPPrrrroooottttooooccccoooollllSSSSttttyyyylllleeee is XXXXmmmmDDDDRRRRAAAAGGGG____DDDDYYYYNNNNAAAAMMMMIIIICCCC or XXXXmmmmDDDDRRRRAAAAGGGG____PPPPRRRREEEEFFFFEEEERRRR____DDDDYYYYNNNNAAAAMMMMIIIICCCC, then a dynamic visual style (cursor) is used. Otherwise, a preregister visual style is used. CCCCllllaaaasssssssseeeessss DragContext inherits behavior and resources from CCCCoooorrrreeee. The class pointer is xxxxmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxttttCCCCllllaaaassssssss. The class name is XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt. NNNNeeeewwww RRRReeeessssoooouuuurrrrcccceeeessss The following table defines a set of widget resources used by the programmer to specify data. The programmer can also set the resource values for the inherited classes to set attributes for this widget. To reference a resource by name or by class in a .Xdefaults file, remove the XXXXmmmmNNNN or XXXXmmmmCCCC prefix and use the remaining letters. To specify one of the defined values for a resource in a .Xdefaults file, remove the XXXXmmmm prefix and use the remaining letters (in either lowercase or uppercase, but include any underscores between words). The codes in the access column indicate if the given resource can be set at creation time (CCCC), set by using XXXXttttSSSSeeeettttVVVVaaaalllluuuueeeessss (SSSS), retrieved by using XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss (GGGG), or is not applicable (NNNN////AAAA). XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss ______________________________________________________________________________________________________________________ XmNblendModel XmCBlendModel unsigned char XmBLEND_ALL CG XmNclientData XmCClientData XtPointer NULL CSG XmNconvertProc XmCConvertProc XtConvertSelectionIncrProc NULL CSG XmNcursorBackground XmCCursorBackground Pixel dynamic CSG XmNcursorForeground XmCCursorForeground Pixel dynamic CSG XmNdragDropFinishCallback XmCCallback XtCallbackList NULL CSG XmNdragMotionCallback XmCCallback XtCallbackList NULL C XmNdragOperations XmCDragOperations unsigned char XmDROP_COPY | XmDROP_MOVE C XmNdropFinishCallback XmCCallback XtCallbackList NULL C XmNdropSiteEnterCallback XmCCallback XtCallbackList NULL C XmNdropSiteLeaveCallback XmCCallback XtCallbackList NULL C XmNdropStartCallback XmCCallback XtCallbackList NULL C XmNexportTargets XmCExportTargets Atom * NULL CSG XmNincremental XmCIncremental Boolean False CSG XmNinvalidCursorForeground XmCCursorForeground Pixel dynamic CSG XmNnoneCursorForeground XmCCursorForeground Pixel dynamic CSG Page 2 (printed 4/30/98) XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) XmNnumExportTargets XmCNumExportTargets Cardinal 0 CSG XmNoperationChangedCallback XmCCallback XtCallbackList NULL C XmNoperationCursorIcon XmCOperationCursorIcon Widget dynamic CSG XmNsourceCursorIcon XmCSourceCursorIcon Widget dynamic CSG XmNsourcePixmapIcon XmCSourcePixmapIcon Widget dynamic CSG XmNstateCursorIcon XmCStateCursorIcon Widget dynamic CSG XmNtopLevelEnterCallback XmCCallback XtCallbackList NULL C XmNtopLevelLeaveCallback XmCCallback XtCallbackList NULL C XmNvalidCursorForeground XmCCursorForeground Pixel dynamic CSG XXXXmmmmNNNNbbbblllleeeennnnddddMMMMooooddddeeeellll Specifies which combination of DragIcons are blended to produce a drag-over visual. XXXXmmmmBBBBLLLLEEEENNNNDDDD____AAAALLLLLLLL Blends all three DragIcons - the source, state and operation icon. The icons are layered from top to bottom with the operation icon on top and the source icon on the bottom. The hotspot is derived from the state icon. XXXXmmmmBBBBLLLLEEEENNNNDDDD____SSSSTTTTAAAATTTTEEEE____SSSSOOOOUUUURRRRCCCCEEEE Blends the state and source icons only. The hotspot is derived from the state icon. XXXXmmmmBBBBLLLLEEEENNNNDDDD____JJJJUUUUSSSSTTTT____SSSSOOOOUUUURRRRCCCCEEEE Specifies that only the source icon is used, which the initiator updates as required. XXXXmmmmBBBBLLLLEEEENNNNDDDD____NNNNOOOONNNNEEEE Specifies that no drag-over visual is generated. The client tracks the drop site status through callback routines and updates the drag-over visuals as necessary. XXXXmmmmNNNNcccclllliiiieeeennnnttttDDDDaaaattttaaaa Specifies the client data to be passed to the XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc when it is invoked. XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc Specifies a procedure of type XXXXttttCCCCoooonnnnvvvveeeerrrrttttSSSSeeeelllleeeeccccttttiiiioooonnnnIIIInnnnccccrrrrPPPPrrrroooocccc that converts the source data to the format(s) requested by the receiver client. The _w_i_d_g_e_t argument passed to this procedure is the DragContext widget. The selection atom passed is _MOTIF_DROP. If Page 3 (printed 4/30/98) XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) XXXXmmmmNNNNiiiinnnnccccrrrreeeemmmmeeeennnnttttaaaallll is False, the procedure should ignore the _m_a_x__l_e_n_g_t_h, _c_l_i_e_n_t__d_a_t_a, and _r_e_q_u_e_s_t__i_d arguments and should handle the conversion atomically. Data returned by XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc must be allocated using XXXXttttMMMMaaaalllllllloooocccc and will be freed automatically by the toolkit after the transfer. For additional information on selection conversion procedures, see _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s-_C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e. XXXXmmmmNNNNccccuuuurrrrssssoooorrrrBBBBaaaacccckkkkggggrrrroooouuuunnnndddd Specifies the background pixel value of the cursor. XXXXmmmmNNNNccccuuuurrrrssssoooorrrrFFFFoooorrrreeeeggggrrrroooouuuunnnndddd Specifies the foreground pixel value of the cursor when the state icon is not blended. This resource defaults to the foreground color of the widget passed to the XXXXmmmmDDDDrrrraaaaggggSSSSttttaaaarrrrtttt function. XXXXmmmmNNNNddddrrrraaaaggggDDDDrrrrooooppppFFFFiiiinnnniiiisssshhhhCCCCaaaallllllllbbbbaaaacccckkkk Specifies the list of callbacks that are called when the transaction is completed. The type of the structure whose address is passed to this callback is XXXXmmmmDDDDrrrraaaaggggDDDDrrrrooooppppFFFFiiiinnnniiiisssshhhhCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt. The reason sent by the callback is XXXXmmmmCCCCRRRR____DDDDRRRRAAAAGGGG____DDDDRRRROOOOPPPP____FFFFIIIINNNNIIIISSSSHHHH. XXXXmmmmNNNNddddrrrraaaaggggMMMMoooottttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk Specifies the list of callbacks that are invoked when the pointer moves. The type of structure whose address is passed to this callback is XXXXmmmmDDDDrrrraaaaggggMMMMoooottttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt. The reason sent by the callback is XXXXmmmmCCCCRRRR____DDDDRRRRAAAAGGGG____MMMMOOOOTTTTIIIIOOOONNNN. XXXXmmmmNNNNddddrrrraaaaggggOOOOppppeeeerrrraaaattttiiiioooonnnnssss Specifies the set of valid operations associated with an initiator client for a drag transaction. This resource is a bit mask that is formed by combining one or more of the following values using a bitwise operation such as inclusive OR (|): XXXXmmmmDDDDRRRROOOOPPPP____CCCCOOOOPPPPYYYY, XXXXmmmmDDDDRRRROOOOPPPP____LLLLIIIINNNNKKKK, XXXXmmmmDDDDRRRROOOOPPPP____MMMMOOOOVVVVEEEE. The value XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP for this resource indicates that no operations are valid. For Text and TextField widgets, this resource is set to XXXXmmmmDDDDRRRROOOOPPPP____CCCCOOOOPPPPYYYY | XXXXmmmmDDDDRRRROOOOPPPP____MMMMOOOOVVVVEEEE; for List widgets, it is set to XXXXmmmmDDDDRRRROOOOPPPP____CCCCOOOOPPPPYYYY. XXXXmmmmNNNNddddrrrrooooppppFFFFiiiinnnniiiisssshhhhCCCCaaaallllllllbbbbaaaacccckkkk Specifies the list of callbacks that are invoked when the drop is completed. The type of the structure whose address is passed to this callback Page 4 (printed 4/30/98) XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) is XXXXmmmmDDDDrrrrooooppppFFFFiiiinnnniiiisssshhhhCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt. The reason sent by the callback is XXXXmmmmCCCCRRRR____DDDDRRRROOOOPPPP____FFFFIIIINNNNIIIISSSSHHHH. XXXXmmmmNNNNddddrrrrooooppppSSSSiiiitttteeeeEEEEnnnntttteeeerrrrCCCCaaaallllllllbbbbaaaacccckkkk Specifies the list of callbacks that are invoked when the pointer enters a drop site. The type of the structure whose address is passed to this callback is XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeeeEEEEnnnntttteeeerrrrCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt. The reason sent by the callback is XXXXmmmmCCCCRRRR____DDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____EEEENNNNTTTTEEEERRRR. XXXXmmmmNNNNddddrrrrooooppppSSSSiiiitttteeeeLLLLeeeeaaaavvvveeeeCCCCaaaallllllllbbbbaaaacccckkkk Specifies the list of callbacks that are invoked when the pointer leaves a drop site. The type of the structure whose address is passed to this callback is XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeeeLLLLeeeeaaaavvvveeeeCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt. The reason sent by the callback is XXXXmmmmCCCCRRRR____DDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____LLLLEEEEAAAAVVVVEEEE. XXXXmmmmNNNNddddrrrrooooppppSSSSttttaaaarrrrttttCCCCaaaallllllllbbbbaaaacccckkkk Specifies the list of callbacks that are invoked when a drop is initiated. The type of the structure whose address is passed to this callback is XXXXmmmmDDDDrrrrooooppppSSSSttttaaaarrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt. The reason sent by the callback is XXXXmmmmCCCCRRRR____DDDDRRRROOOOPPPP____SSSSTTTTAAAARRRRTTTT. XXXXmmmmNNNNeeeexxxxppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss Specifies the list of target atoms associated with this source. This resource identifies the selection targets this source can be converted to. XXXXmmmmNNNNiiiinnnnccccrrrreeeemmmmeeeennnnttttaaaallll Specifies a Boolean value that indicates whether the transfer on the initiator side uses the Xt incremental selection transfer mechanism described in _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s-_C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e. If the value is True, the initiator uses incremental transfer; if the value is False, the initiator uses atomic transfer. XXXXmmmmNNNNiiiinnnnvvvvaaaalllliiiiddddCCCCuuuurrrrssssoooorrrrFFFFoooorrrreeeeggggrrrroooouuuunnnndddd Specifies the foreground pixel value of the cursor when the state is invalid. This resource defaults to the value of the XXXXmmmmNNNNccccuuuurrrrssssoooorrrrFFFFoooorrrreeeeggggrrrroooouuuunnnndddd resource. XXXXmmmmNNNNnnnnoooonnnneeeeCCCCuuuurrrrssssoooorrrrFFFFoooorrrreeeeggggrrrroooouuuunnnndddd Specifies the foreground pixel value of the cursor when the state is none. This resource defaults to the value of the XXXXmmmmNNNNccccuuuurrrrssssoooorrrrFFFFoooorrrreeeeggggrrrroooouuuunnnndddd resource. XXXXmmmmNNNNnnnnuuuummmmEEEExxxxppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss Specifies the number of entries in the list of Page 5 (printed 4/30/98) XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) export targets. XXXXmmmmNNNNooooppppeeeerrrraaaattttiiiioooonnnnCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk Specifies the list of callbacks that are invoked when the drag is started and when the user requests that a different operation be applied to the drop. The type of the structure whose address is passed to this callback is XXXXmmmmOOOOppppeeeerrrraaaattttiiiioooonnnnCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt. The reason sent by the callback is XXXXmmmmCCCCRRRR____OOOOPPPPEEEERRRRAAAATTTTIIIIOOOONNNN____CCCCHHHHAAAANNNNGGGGEEEEDDDD. XXXXmmmmNNNNooooppppeeeerrrraaaattttiiiioooonnnnCCCCuuuurrrrssssoooorrrrIIIIccccoooonnnn Specifies the cursor icon used to designate the type of operation performed by the drag transaction. If NULL, XXXXmmmmSSSSccccrrrreeeeeeeennnn resources provide default icons for copy, link, and move operations. XXXXmmmmNNNNssssoooouuuurrrrcccceeeeCCCCuuuurrrrssssoooorrrrIIIIccccoooonnnn Specifies the cursor icon used to represent the source when a dynamic visual style is used. If NULL, the XXXXmmmmNNNNddddeeeeffffaaaauuuullllttttSSSSoooouuuurrrrcccceeeeCCCCuuuurrrrssssoooorrrrIIIIccccoooonnnn resource of XXXXmmmmSSSSccccrrrreeeeeeeennnn provides a default cursor icon. XXXXmmmmNNNNssssoooouuuurrrrcccceeeePPPPiiiixxxxmmmmaaaappppIIIIccccoooonnnn Specifies the pixmap icon used to represent the source when a preregister visual style is used. The icon is used in conjunction with the colormap of the widget passed to XXXXmmmmDDDDrrrraaaaggggSSSSttttaaaarrrrtttt. If NULL, XXXXmmmmNNNNssssoooouuuurrrrcccceeeeCCCCuuuurrrrssssoooorrrrIIIIccccoooonnnn is used. XXXXmmmmNNNNssssttttaaaatttteeeeCCCCuuuurrrrssssoooorrrrIIIIccccoooonnnn Specifies the cursor icon used to designate the state of a drop site. If NULL, XXXXmmmmSSSSccccrrrreeeeeeeennnn resources provide default icons for a valid, invalid, and no drop site condition. XXXXmmmmNNNNttttooooppppLLLLeeeevvvveeeellllEEEEnnnntttteeeerrrrCCCCaaaallllllllbbbbaaaacccckkkk Specifies the list of callbacks that are called when the pointer enters a top-level window or root window (due to changing screens). The type of the structure whose address is passed to this callback is XXXXmmmmTTTTooooppppLLLLeeeevvvveeeellllEEEEnnnntttteeeerrrrCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt. The reason sent by the callback is XXXXmmmmCCCCRRRR____TTTTOOOOPPPP____LLLLEEEEVVVVEEEELLLL____EEEENNNNTTTTEEEERRRR. XXXXmmmmNNNNttttooooppppLLLLeeeevvvveeeellllLLLLeeeeaaaavvvveeeeCCCCaaaallllllllbbbbaaaacccckkkk Specifies the list of callbacks that are called when the pointer leaves a top level window or the root window (due to changing screens). The type of the structure whose address is passed to this callback is XXXXmmmmTTTTooooppppLLLLeeeevvvveeeellllLLLLeeeeaaaavvvveeeeCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt. The reason sent by the callback is XXXXmmmmCCCCRRRR____TTTTOOOOPPPP____LLLLEEEEVVVVEEEELLLL____LLLLEEEEAAAAVVVVEEEE. Page 6 (printed 4/30/98) XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) XXXXmmmmNNNNvvvvaaaalllliiiiddddCCCCuuuurrrrssssoooorrrrFFFFoooorrrreeeeggggrrrroooouuuunnnndddd Specifies the foreground pixel value of the cursor designated as a valid cursor icon. IIIInnnnhhhheeeerrrriiiitttteeeedddd RRRReeeessssoooouuuurrrrcccceeeessss DragContext inherits behavior and resources from the following superclass. For a complete description of each resource, refer to the CCCCoooorrrreeee man page. CCCCoooorrrreeee RRRReeeessssoooouuuurrrrcccceeee SSSSeeeetttt NNNNaaaammmmeeee CCCCllllaaaassssssss TTTTyyyyppppeeee DDDDeeeeffffaaaauuuulllltttt AAAAcccccccceeeessssssss ______________________________________________________________________________________________________________ XmNaccelerators XmCAccelerators XtAccelerators dynamic CSG XmNancestorSensitive XmCSensitive Boolean dynamic G XmNbackground XmCBackground Pixel dynamic CSG XmNbackgroundPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNborderColor XmCBorderColor Pixel XtDefaultForeground CSG XmNborderPixmap XmCPixmap Pixmap XmUNSPECIFIED_PIXMAP CSG XmNborderWidth XmCBorderWidth Dimension 0 CSG XmNcolormap XmCColormap Colormap dynamic CG XmNdepth XmCDepth int dynamic CG XmNdestroyCallback XmCCallback XtCallbackList NULL C XmNheight XmCHeight Dimension dynamic CSG XmNinitialResourcesPersistent XmCInitialResourcesPersistent Boolean True C XmNmappedWhenManaged XmCMappedWhenManaged Boolean True CSG XmNscreen XmCScreen Screen * dynamic CG XmNsensitive XmCSensitive Boolean True CSG XmNtranslations XmCTranslations XtTranslations dynamic CSG XmNwidth XmCWidth Dimension dynamic CSG XmNx XmCPosition Position 0 CSG XmNy XmCPosition Position 0 CSG CCCCaaaallllllllbbbbaaaacccckkkk IIIInnnnffffoooorrrrmmmmaaaattttiiiioooonnnn Each of the DragContext callbacks has an associated callback structure. A pointer to the following structure is passed to the XXXXmmmmNNNNddddrrrraaaaggggDDDDrrrrooooppppFFFFiiiinnnniiiisssshhhhCCCCaaaallllllllbbbbaaaacccckkkk callback. ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt {{{{ iiiinnnntttt _r_e_a_s_o_n;;;; XXXXEEEEvvvveeeennnntttt ****_e_v_e_n_t;;;; TTTTiiiimmmmeeee _t_i_m_e_S_t_a_m_p;;;; }}}}XXXXmmmmDDDDrrrraaaaggggDDDDrrrrooooppppFFFFiiiinnnniiiisssshhhhCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt,,,, ****XXXXmmmmDDDDrrrraaaaggggDDDDrrrrooooppppFFFFiiiinnnniiiisssshhhhCCCCaaaallllllllbbbbaaaacccckkkk;;;; _r_e_a_s_o_n Indicates why the callback was invoked. _e_v_e_n_t Points to the XXXXEEEEvvvveeeennnntttt that triggered the callback. Page 7 (printed 4/30/98) XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) _t_i_m_e_s_t_a_m_p Specifies the time at which either the drag or the drop was completed. A pointer to the following structure is passed to callbacks for XXXXmmmmNNNNddddrrrraaaaggggMMMMoooottttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk. ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt {{{{ iiiinnnntttt _r_e_a_s_o_n;;;; XXXXEEEEvvvveeeennnntttt ****_e_v_e_n_t;;;; TTTTiiiimmmmeeee _t_i_m_e_S_t_a_m_p;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_o_p_e_r_a_t_i_o_n;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_o_p_e_r_a_t_i_o_n_s;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_d_r_o_p_S_i_t_e_S_t_a_t_u_s;;;; PPPPoooossssiiiittttiiiioooonnnn _x;;;; PPPPoooossssiiiittttiiiioooonnnn _y;;;; }}}}XXXXmmmmDDDDrrrraaaaggggMMMMoooottttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt,,,, ****XXXXmmmmDDDDrrrraaaaggggMMMMoooottttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk;;;; _r_e_a_s_o_n Indicates why the callback was invoked. _e_v_e_n_t Points to the XXXXEEEEvvvveeeennnntttt that triggered the callback. _t_i_m_e_S_t_a_m_p Specifies the timestamp of the logical event. _o_p_e_r_a_t_i_o_n Identifies an operation. If the toolkit has just called a DropSite's XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc, the toolkit initializes _o_p_e_r_a_t_i_o_n to the value of the _o_p_e_r_a_t_i_o_n member of the XXXXmmmmDDDDrrrraaaaggggPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt at the time the DropSite's XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc returns. If the toolkit has not called an XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc and the pointer is within an active drop site, the toolkit initializes _o_p_e_r_a_t_i_o_n by selecting an operation from the bitwise AND of the initial value of the _o_p_e_r_a_t_i_o_n_s member and the value of the DropSite's XXXXmmmmNNNNddddrrrrooooppppSSSSiiiitttteeeeOOOOppppeeeerrrraaaattttiiiioooonnnnssss resource. The toolkit searches this set first for XXXXmmmmDDDDRRRROOOOPPPP____MMMMOOOOVVVVEEEE, then for XXXXmmmmDDDDRRRROOOOPPPP____CCCCOOOOPPPPYYYY, then for XXXXmmmmDDDDRRRROOOOPPPP____LLLLIIIINNNNKKKK, and initializes _o_p_e_r_a_t_i_o_n to the first operation it finds in the set. If the toolkit finds none of these operations in the set, it initializes _o_p_e_r_a_t_i_o_n to XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP. If the toolkit has not called an XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc and the pointer is not within an active drop site, the toolkit initializes _o_p_e_r_a_t_i_o_n by selecting an operation from the initial value of the Page 8 (printed 4/30/98) XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) _o_p_e_r_a_t_i_o_n_s member. The toolkit searches this set first for XXXXmmmmDDDDRRRROOOOPPPP____MMMMOOOOVVVVEEEE, then for XXXXmmmmDDDDRRRROOOOPPPP____CCCCOOOOPPPPYYYY, then for XXXXmmmmDDDDRRRROOOOPPPP____LLLLIIIINNNNKKKK, and initializes _o_p_e_r_a_t_i_o_n to the first operation it finds in the set. If the toolkit finds none of these operations in the set, it initializes _o_p_e_r_a_t_i_o_n to XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP. _o_p_e_r_a_t_i_o_n_s Indicates the set of operations supported for the source data. If the toolkit has just called a DropSite's XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to the bitwise AND of the DropSite's XXXXmmmmNNNNddddrrrrooooppppOOOOppppeeeerrrraaaattttiiiioooonnnnssss and the value of the _o_p_e_r_a_t_i_o_n_s member of the XXXXmmmmDDDDrrrraaaaggggPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt at the time the DropSite's XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc returns. If the resulting set of operations is empty, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP. If the toolkit has not called an XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc and the user does not select an operation (by pressing a modifier key), the toolkit initializes _o_p_e_r_a_t_i_o_n_s to the value of the DragContext's XXXXmmmmNNNNddddrrrraaaaggggOOOOppppeeeerrrraaaattttiiiioooonnnnssss resource. If the toolkit has not called an XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc and the user does select an operation, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to the bitwise AND of the corresponding operation and the value of the DragContext's XXXXmmmmNNNNddddrrrraaaaggggOOOOppppeeeerrrraaaattttiiiioooonnnnssss resource. If the resulting set of operations is empty, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP. _d_r_o_p_S_i_t_e_S_t_a_t_u_s Indicates whether or not a drop site is valid. If the toolkit has just called a DropSite's XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc, the toolkit initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s to the value of the _d_r_o_p_S_i_t_e_S_t_a_t_u_s member of the XXXXmmmmDDDDrrrraaaaggggPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt at the time the DropSite's XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc returns. If the toolkit has not called an XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc, it initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s as follows: the toolkit initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s to XXXXmmmmNNNNOOOO____DDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE if the pointer is over an inactive drop site or is not over a drop site. The toolkit initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s to XXXXmmmmDDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____VVVVAAAALLLLIIIIDDDD if all the following Page 9 (printed 4/30/98) XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) conditions are met: +o The pointer is over an active drop site. +o The DragContext's XXXXmmmmNNNNeeeexxxxppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss and the DropSite's XXXXmmmmNNNNiiiimmmmppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss are compatible. +o The initial value of the _o_p_e_r_a_t_i_o_n member is not XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP. Otherwise, the toolkit initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s to XXXXmmmmDDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____IIIINNNNVVVVAAAALLLLIIIIDDDD. A pointer to the following structure is passed for the XXXXmmmmNNNNddddrrrrooooppppFFFFiiiinnnniiiisssshhhhCCCCaaaallllllllbbbbaaaacccckkkk callback: ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt {{{{ iiiinnnntttt _r_e_a_s_o_n;;;; XXXXEEEEvvvveeeennnntttt ****_e_v_e_n_t;;;; TTTTiiiimmmmeeee _t_i_m_e_S_t_a_m_p;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_o_p_e_r_a_t_i_o_n;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_o_p_e_r_a_t_i_o_n_s;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_d_r_o_p_S_i_t_e_S_t_a_t_u_s;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_d_r_o_p_A_c_t_i_o_n;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_c_o_m_p_l_e_t_i_o_n_S_t_a_t_u_s;;;; }}}}XXXXmmmmDDDDrrrrooooppppFFFFiiiinnnniiiisssshhhhCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt,,,, ****XXXXmmmmDDDDrrrrooooppppFFFFiiiinnnniiiisssshhhhCCCCaaaallllllllbbbbaaaacccckkkk;;;; _r_e_a_s_o_n Indicates why the callback was invoked. _e_v_e_n_t Points to the XXXXEEEEvvvveeeennnntttt that triggered the callback. _t_i_m_e_S_t_a_m_p Specifies the time at which the drop was completed. _o_p_e_r_a_t_i_o_n Identifies an operation. If the pointer is over an active drop site when the drop begins, the toolkit initializes _o_p_e_r_a_t_i_o_n to the value of the _o_p_e_r_a_t_i_o_n member of the XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt at the time the DropSite's XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc returns. If the pointer is not over an active drop site when the drop begins, the toolkit initializes _o_p_e_r_a_t_i_o_n by selecting an operation from the initial value of the _o_p_e_r_a_t_i_o_n_s member. The toolkit searches this set first for XXXXmmmmDDDDRRRROOOOPPPP____MMMMOOOOVVVVEEEE, Page 10 (printed 4/30/98) XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) then for XXXXmmmmDDDDRRRROOOOPPPP____CCCCOOOOPPPPYYYY, then for XXXXmmmmDDDDRRRROOOOPPPP____LLLLIIIINNNNKKKK, and initializes _o_p_e_r_a_t_i_o_n to the first operation it finds in the set. If it finds none of these operations in the set, it initializes _o_p_e_r_a_t_i_o_n to XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP. _o_p_e_r_a_t_i_o_n_s Indicates the set of operations supported for the source data. If the pointer is over an active drop site when the drop begins, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to the bitwise AND of the DropSite's XXXXmmmmNNNNddddrrrrooooppppOOOOppppeeeerrrraaaattttiiiioooonnnnssss and the value of the _o_p_e_r_a_t_i_o_n_s member of the XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt at the time the DropSite's XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc returns. If the resulting set of operations is empty, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP. If the pointer is not over an active drop site when the drop begins and if the user does not select an operation (by pressing a modifier key), the toolkit initializes _o_p_e_r_a_t_i_o_n_s to the value of the DragContext's XXXXmmmmNNNNddddrrrraaaaggggOOOOppppeeeerrrraaaattttiiiioooonnnnssss resource. If the pointer is not over an active drop site when the drop begins and if the user does select an operation, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to the bitwise AND of the corresponding operation and the value of the DragContext's XXXXmmmmNNNNddddrrrraaaaggggOOOOppppeeeerrrraaaattttiiiioooonnnnssss resource. If the resulting set of operations is empty, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP. _d_r_o_p_S_i_t_e_S_t_a_t_u_s Indicates whether or not a drop site is valid. If the pointer is over an active drop site when the drop begins, the toolkit initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s to the value of the _d_r_o_p_S_i_t_e_S_t_a_t_u_s member of the XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt at the time the DropSite's XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc returns. If the pointer is not over an active drop site when the drop begins, the toolkit initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s to XXXXmmmmNNNNOOOO____DDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE. _d_r_o_p_A_c_t_i_o_n Identifies the drop action. The values are: XXXXmmmmDDDDRRRROOOOPPPP, XXXXmmmmDDDDRRRROOOOPPPP____CCCCAAAANNNNCCCCEEEELLLL, XXXXmmmmDDDDRRRROOOOPPPP____HHHHEEEELLLLPPPP, and XXXXmmmmDDDDRRRROOOOPPPP____IIIINNNNTTTTEEEERRRRRRRRUUUUPPPPTTTT. The value XXXXmmmmDDDDRRRROOOOPPPP____IIIINNNNTTTTEEEERRRRRRRRUUUUPPPPTTTT is Page 11 (printed 4/30/98) XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) currently unsupported; if specified, it will be interpreted as an XXXXmmmmDDDDRRRROOOOPPPP____CCCCAAAANNNNCCCCEEEELLLL. _c_o_m_p_l_e_t_i_o_n_S_t_a_t_u_s An IN/OUT member that indicates the status of the drop action. After the last callback procedure has returned, the final value of this member determines what visual transition effects will be applied. There are two values: XXXXmmmmDDDDRRRROOOOPPPP____SSSSUUUUCCCCCCCCEEEESSSSSSSS The drop was successful. XXXXmmmmDDDDRRRROOOOPPPP____FFFFAAAAIIIILLLLUUUURRRREEEE The drop was unsuccessful. A pointer to the following structure is passed to callbacks for XXXXmmmmNNNNddddrrrrooooppppSSSSiiiitttteeeeEEEEnnnntttteeeerrrrCCCCaaaallllllllbbbbaaaacccckkkk: ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt {{{{ iiiinnnntttt _r_e_a_s_o_n;;;; XXXXEEEEvvvveeeennnntttt ****_e_v_e_n_t;;;; TTTTiiiimmmmeeee _t_i_m_e_S_t_a_m_p;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_o_p_e_r_a_t_i_o_n;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_o_p_e_r_a_t_i_o_n_s;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_d_r_o_p_S_i_t_e_S_t_a_t_u_s;;;; PPPPoooossssiiiittttiiiioooonnnn _x;;;; PPPPoooossssiiiittttiiiioooonnnn _y;;;; }}}}XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeeeEEEEnnnntttteeeerrrrCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt,,,, ****XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeeeEEEEnnnntttteeeerrrrCCCCaaaallllllllbbbbaaaacccckkkk;;;; _r_e_a_s_o_n Indicates why the callback was invoked. _e_v_e_n_t Points to the XXXXEEEEvvvveeeennnntttt that triggered the callback. _t_i_m_e_s_t_a_m_p Specifies the time the crossing event occurred. _o_p_e_r_a_t_i_o_n Identifies an operation. If the toolkit has just called a DropSite's XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc, the toolkit initializes _o_p_e_r_a_t_i_o_n to the value of the _o_p_e_r_a_t_i_o_n member of the XXXXmmmmDDDDrrrraaaaggggPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt at the time the DropSite's XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc returns. If the toolkit has not called an XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc, it initializes _o_p_e_r_a_t_i_o_n by selecting an operation from the bitwise AND of the initial value of the Page 12 (printed 4/30/98) XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) _o_p_e_r_a_t_i_o_n_s member and the value of the DropSite's XXXXmmmmNNNNddddrrrrooooppppSSSSiiiitttteeeeOOOOppppeeeerrrraaaattttiiiioooonnnnssss resource. The toolkit searches this set first for XXXXmmmmDDDDRRRROOOOPPPP____MMMMOOOOVVVVEEEE, then for XXXXmmmmDDDDRRRROOOOPPPP____CCCCOOOOPPPPYYYY, then for XXXXmmmmDDDDRRRROOOOPPPP____LLLLIIIINNNNKKKK, and initializes _o_p_e_r_a_t_i_o_n to the first operation it finds in the set. If the toolkit finds none of these operations in the set, it initializes _o_p_e_r_a_t_i_o_n to XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP. _o_p_e_r_a_t_i_o_n_s Indicates the set of operations supported for the source data. If the toolkit has just called a DropSite's XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to the bitwise AND of the DropSite's XXXXmmmmNNNNddddrrrrooooppppOOOOppppeeeerrrraaaattttiiiioooonnnnssss and the value of the _o_p_e_r_a_t_i_o_n_s member of the XXXXmmmmDDDDrrrraaaaggggPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt at the time the DropSite's XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc returns. If the resulting set of operations is empty, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP. If the toolkit has not called an XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc and the user does not select an operation (by pressing a modifier key), the toolkit initializes _o_p_e_r_a_t_i_o_n_s to the value of the DragContext's XXXXmmmmNNNNddddrrrraaaaggggOOOOppppeeeerrrraaaattttiiiioooonnnnssss resource. If the toolkit has not called an XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc and the user does select an operation, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to the bitwise AND of the corresponding operation and the value of the DragContext's XXXXmmmmNNNNddddrrrraaaaggggOOOOppppeeeerrrraaaattttiiiioooonnnnssss resource. If the resulting set of operations is empty, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP. _d_r_o_p_S_i_t_e_S_t_a_t_u_s Indicates whether or not a drop site is valid. If the toolkit has just called a DropSite's XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc, the toolkit initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s to the value of the _d_r_o_p_S_i_t_e_S_t_a_t_u_s member of the XXXXmmmmDDDDrrrraaaaggggPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt at the time the DropSite's XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc returns. If the toolkit has not called an XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc, it initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s as follows: the toolkit initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s to XXXXmmmmDDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____VVVVAAAALLLLIIIIDDDD if the DragContext's XXXXmmmmNNNNeeeexxxxppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss and the DropSite's XXXXmmmmNNNNiiiimmmmppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss are compatible and if the Page 13 (printed 4/30/98) XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) initial value of the _o_p_e_r_a_t_i_o_n member is not XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP. Otherwise, the toolkit initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s to XXXXmmmmDDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____IIIINNNNVVVVAAAALLLLIIIIDDDD. _x Indicates the x-coordinate of the pointer in root window coordinates. _y Indicates the y-coordinate of the pointer in root window coordinates. A pointer to the following structure is passed to callbacks for XXXXmmmmNNNNddddrrrrooooppppSSSSiiiitttteeeeLLLLeeeeaaaavvvveeeeCCCCaaaallllllllbbbbaaaacccckkkk. ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt {{{{ iiiinnnntttt _r_e_a_s_o_n;;;; XXXXEEEEvvvveeeennnntttt ****_e_v_e_n_t;;;; TTTTiiiimmmmeeee _t_i_m_e_S_t_a_m_p;;;; }}}}XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeeeLLLLeeeeaaaavvvveeeeCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt,,,, ****XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeeeLLLLeeeeaaaavvvveeeeCCCCaaaallllllllbbbbaaaacccckkkk;;;; _r_e_a_s_o_n Indicates why the callback was invoked. _e_v_e_n_t Points to the XXXXEEEEvvvveeeennnntttt that triggered the callback. _t_i_m_e_S_t_a_m_p Specifies the timestamp of the logical event. A pointer to the following structure is passed for the XXXXmmmmNNNNddddrrrrooooppppSSSSttttaaaarrrrttttCCCCaaaallllllllbbbbaaaacccckkkk callback: ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt {{{{ iiiinnnntttt _r_e_a_s_o_n;;;; XXXXEEEEvvvveeeennnntttt ****_e_v_e_n_t;;;; TTTTiiiimmmmeeee _t_i_m_e_S_t_a_m_p;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_o_p_e_r_a_t_i_o_n;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_o_p_e_r_a_t_i_o_n_s;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_d_r_o_p_S_i_t_e_S_t_a_t_u_s;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_d_r_o_p_A_c_t_i_o_n;;;; PPPPoooossssiiiittttiiiioooonnnn _x;;;; PPPPoooossssiiiittttiiiioooonnnn _y;;;; }}}}XXXXmmmmDDDDrrrrooooppppSSSSttttaaaarrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt,,,, ****XXXXmmmmDDDDrrrrooooppppSSSSttttaaaarrrrttttCCCCaaaallllllllbbbbaaaacccckkkk;;;; _r_e_a_s_o_n Indicates why the callback was invoked. _e_v_e_n_t Points to the XXXXEEEEvvvveeeennnntttt that triggered the callback. Page 14 (printed 4/30/98) XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) _t_i_m_e_S_t_a_m_p Specifies the time at which the drag was completed. _o_p_e_r_a_t_i_o_n Identifies an operation. If the pointer is over an active drop site when the drop begins, the toolkit initializes _o_p_e_r_a_t_i_o_n to the value of the _o_p_e_r_a_t_i_o_n member of the XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt at the time the DropSite's XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc returns. If the pointer is not over an active drop site when the drop begins, the toolkit initializes _o_p_e_r_a_t_i_o_n by selecting an operation from the initial value of the _o_p_e_r_a_t_i_o_n_s member. The toolkit searches this set first for XXXXmmmmDDDDRRRROOOOPPPP____MMMMOOOOVVVVEEEE, then for XXXXmmmmDDDDRRRROOOOPPPP____CCCCOOOOPPPPYYYY, then for XXXXmmmmDDDDRRRROOOOPPPP____LLLLIIIINNNNKKKK, and initializes _o_p_e_r_a_t_i_o_n to the first operation it finds in the set. If it finds none of these operations in the set, it initializes _o_p_e_r_a_t_i_o_n to XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP. _o_p_e_r_a_t_i_o_n_s Indicates the set of operations supported for the source data. If the pointer is over an active drop site when the drop begins, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to the bitwise AND of the DropSite's XXXXmmmmNNNNddddrrrrooooppppOOOOppppeeeerrrraaaattttiiiioooonnnnssss and the value of the _o_p_e_r_a_t_i_o_n_s member of the XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt at the time the DropSite's XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc returns. If the resulting set of operations is empty, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP. If the pointer is not over an active drop site when the drop begins and if the user does not select an operation (by pressing a modifier key), the toolkit initializes _o_p_e_r_a_t_i_o_n_s to the value of the DragContext's XXXXmmmmNNNNddddrrrraaaaggggOOOOppppeeeerrrraaaattttiiiioooonnnnssss resource. If the pointer is not over an active drop site when the drop begins and if the user does select an operation, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to the bitwise AND of the corresponding operation and the value of the DragContext's XXXXmmmmNNNNddddrrrraaaaggggOOOOppppeeeerrrraaaattttiiiioooonnnnssss resource. If the resulting set of operations is empty, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP. _d_r_o_p_S_i_t_e_S_t_a_t_u_s Page 15 (printed 4/30/98) XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) Indicates whether or not a drop site is valid. If the pointer is over an active drop site when the drop begins, the toolkit initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s to the value of the _d_r_o_p_S_i_t_e_S_t_a_t_u_s member of the XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt at the time the DropSite's XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc returns. If the pointer is not over an active drop site when the drop begins, the toolkit initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s to XXXXmmmmNNNNOOOO____DDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE. _d_r_o_p_A_c_t_i_o_n An IN/OUT member that identifies the drop action. The values are XXXXmmmmDDDDRRRROOOOPPPP, XXXXmmmmDDDDRRRROOOOPPPP____CCCCAAAANNNNCCCCEEEELLLL, XXXXmmmmDDDDRRRROOOOPPPP____HHHHEEEELLLLPPPP, and XXXXmmmmDDDDRRRROOOOPPPP____IIIINNNNTTTTEEEERRRRRRRRUUUUPPPPTTTT. The value of _d_r_o_p_A_c_t_i_o_n can be modified to change the action actually initiated. The value XXXXmmmmDDDDRRRROOOOPPPP____IIIINNNNTTTTEEEERRRRRRRRUUUUPPPPTTTT is currently unsupported; if specified, it will be interpreted as a XXXXmmmmDDDDRRRROOOOPPPP____CCCCAAAANNNNCCCCEEEELLLL. _x Indicates the x-coordinate of the pointer in root window coordinates. _y Indicates the y-coordinate of the pointer in root window coordinates. A pointer to the following structure is passed to the XXXXmmmmNNNNooooppppeeeerrrraaaattttiiiioooonnnnCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk callback: ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt {{{{ iiiinnnntttt _r_e_a_s_o_n;;;; XXXXEEEEvvvveeeennnntttt ****_e_v_e_n_t;;;; TTTTiiiimmmmeeee _t_i_m_e_S_t_a_m_p;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_o_p_e_r_a_t_i_o_n;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_o_p_e_r_a_t_i_o_n_s;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_d_r_o_p_S_i_t_e_S_t_a_t_u_s;;;; }}}}XXXXmmmmOOOOppppeeeerrrraaaattttiiiioooonnnnCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt,,,, ****XXXXmmmmOOOOppppeeeerrrraaaattttiiiioooonnnnCCCChhhhaaaannnnggggeeeeddddCCCCaaaallllllllbbbbaaaacccckkkk;;;; _r_e_a_s_o_n Indicates why the callback was invoked. _e_v_e_n_t Points to the XXXXEEEEvvvveeeennnntttt that triggered the callback. _t_i_m_e_s_t_a_m_p Specifies the time at which the crossing event occurred. _o_p_e_r_a_t_i_o_n Identifies an operation. Page 16 (printed 4/30/98) XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) If the toolkit has just called a DropSite's XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc, the toolkit initializes _o_p_e_r_a_t_i_o_n to the value of the _o_p_e_r_a_t_i_o_n member of the XXXXmmmmDDDDrrrraaaaggggPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt at the time the DropSite's XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc returns. If the toolkit has not called an XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc and the pointer is within an active drop site, the toolkit initializes _o_p_e_r_a_t_i_o_n by selecting an operation from the bitwise AND of the initial value of the _o_p_e_r_a_t_i_o_n_s member and the value of the DropSite's XXXXmmmmNNNNddddrrrrooooppppSSSSiiiitttteeeeOOOOppppeeeerrrraaaattttiiiioooonnnnssss resource. The toolkit searches this set first for XXXXmmmmDDDDRRRROOOOPPPP____MMMMOOOOVVVVEEEE, then for XXXXmmmmDDDDRRRROOOOPPPP____CCCCOOOOPPPPYYYY, then for XXXXmmmmDDDDRRRROOOOPPPP____LLLLIIIINNNNKKKK, and initializes _o_p_e_r_a_t_i_o_n to the first operation it finds in the set. If the toolkit finds none of these operations in the set, it initializes _o_p_e_r_a_t_i_o_n to XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP. If the toolkit has not called an XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc and the pointer is not within an active drop site, the toolkit initializes _o_p_e_r_a_t_i_o_n by selecting an operation from the initial value of the _o_p_e_r_a_t_i_o_n_s member. The toolkit searches this set first for XXXXmmmmDDDDRRRROOOOPPPP____MMMMOOOOVVVVEEEE, then for XXXXmmmmDDDDRRRROOOOPPPP____CCCCOOOOPPPPYYYY, then for XXXXmmmmDDDDRRRROOOOPPPP____LLLLIIIINNNNKKKK, and initializes _o_p_e_r_a_t_i_o_n to the first operation it finds in the set. If the toolkit finds none of these operations in the set, it initializes _o_p_e_r_a_t_i_o_n to XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP. _o_p_e_r_a_t_i_o_n_s Indicates the set of operations supported for the source data. If the toolkit has just called a DropSite's XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to the bitwise AND of the DropSite's XXXXmmmmNNNNddddrrrrooooppppOOOOppppeeeerrrraaaattttiiiioooonnnnssss and the value of the _o_p_e_r_a_t_i_o_n_s member of the XXXXmmmmDDDDrrrraaaaggggPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt at the time the DropSite's XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc returns. If the resulting set of operations is empty, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP. If the toolkit has not called an XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc and the user does not select an operation (by pressing a modifier key), the toolkit initializes _o_p_e_r_a_t_i_o_n_s to the value of the DragContext's XXXXmmmmNNNNddddrrrraaaaggggOOOOppppeeeerrrraaaattttiiiioooonnnnssss resource. If the toolkit has not called an XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc and the user does select an operation, the toolkit Page 17 (printed 4/30/98) XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) initializes _o_p_e_r_a_t_i_o_n_s to the bitwise AND of the corresponding operation and the value of the DragContext's XXXXmmmmNNNNddddrrrraaaaggggOOOOppppeeeerrrraaaattttiiiioooonnnnssss resource. If the resulting set of operations is empty, the toolkit initializes _o_p_e_r_a_t_i_o_n_s to XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP. _d_r_o_p_S_i_t_e_S_t_a_t_u_s Indicates whether or not a drop site is valid. If the toolkit has just called a DropSite's XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc, the toolkit initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s to the value of the _d_r_o_p_S_i_t_e_S_t_a_t_u_s member of the XXXXmmmmDDDDrrrraaaaggggPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt at the time the DropSite's XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc returns. If the toolkit has not called an XXXXmmmmNNNNddddrrrraaaaggggPPPPrrrroooocccc, it initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s as follows: the toolkit initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s to XXXXmmmmNNNNOOOO____DDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE if the pointer is over an inactive drop site or is not over a drop site. The toolkit initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s to XXXXmmmmDDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____VVVVAAAALLLLIIIIDDDD if all the following conditions are met: +o The pointer is over an active drop site +o The DragContext's XXXXmmmmNNNNeeeexxxxppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss and the DropSite's XXXXmmmmNNNNiiiimmmmppppoooorrrrttttTTTTaaaarrrrggggeeeettttssss are compatible +o The initial value of the _o_p_e_r_a_t_i_o_n member is not XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP Otherwise, the toolkit initializes _d_r_o_p_S_i_t_e_S_t_a_t_u_s to XXXXmmmmDDDDRRRROOOOPPPP____SSSSIIIITTTTEEEE____IIIINNNNVVVVAAAALLLLIIIIDDDD. A pointer to the following structure is passed to callbacks for XXXXmmmmNNNNttttooooppppLLLLeeeevvvveeeellllEEEEnnnntttteeeerrrrCCCCaaaallllllllbbbbaaaacccckkkk: ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt {{{{ iiiinnnntttt _r_e_a_s_o_n;;;; XXXXEEEEvvvveeeennnntttt ****_e_v_e_n_t;;;; TTTTiiiimmmmeeee _t_i_m_e_s_t_a_m_p;;;; SSSSccccrrrreeeeeeeennnn _s_c_r_e_e_n;;;; WWWWiiiinnnnddddoooowwww _w_i_n_d_o_w;;;; PPPPoooossssiiiittttiiiioooonnnn _x;;;; PPPPoooossssiiiittttiiiioooonnnn _y;;;; uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr_d_r_a_g_P_r_o_t_o_c_o_l_S_t_y_l_e;;;; }}}}XXXXmmmmTTTTooooppppLLLLeeeevvvveeeellllEEEEnnnntttteeeerrrrCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt,,,, ****XXXXmmmmTTTTooooppppLLLLeeeevvvveeeellllEEEEnnnntttteeeerrrrCCCCaaaallllllllbbbbaaaacccckkkk;;;; Page 18 (printed 4/30/98) XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) _r_e_a_s_o_n Indicates why the callback was invoked. _e_v_e_n_t Points to the XXXXEEEEvvvveeeennnntttt that triggered the callback. _t_i_m_e_S_t_a_m_p Specifies the timestamp of the logical event. _s_c_r_e_e_n Specifies the screen associated with the top- level window or root window being entered. _w_i_n_d_o_w Specifies the ID of the top-level window or root window being entered. _x Indicates the x-coordinate of the pointer in root window coordinates. _y Indicates the y-coordinate of the pointer in root window coordinates. _d_r_a_g_P_r_o_t_o_c_o_l_S_t_y_l_e Specifies the protocol style adopted by the initiator. The values are XXXXmmmmDDDDRRRRAAAAGGGG____DDDDRRRROOOOPPPP____OOOONNNNLLLLYYYY, XXXXmmmmDDDDRRRRAAAAGGGG____DDDDYYYYNNNNAAAAMMMMIIIICCCC, XXXXmmmmDDDDRRRRAAAAGGGG____NNNNOOOONNNNEEEE, and XXXXmmmmDDDDRRRRAAAAGGGG____PPPPRRRREEEERRRREEEEGGGGIIIISSSSTTTTEEEERRRR. A pointer to the following structure is passed to callbacks for XXXXmmmmNNNNttttooooppppLLLLeeeevvvveeeellllLLLLeeeeaaaavvvveeeeCCCCaaaallllllllbbbbaaaacccckkkk: ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt {{{{ iiiinnnntttt _r_e_a_s_o_n;;;; XXXXEEEEvvvveeeennnntttt ****_e_v_e_n_t;;;; TTTTiiiimmmmeeee _t_i_m_e_s_t_a_m_p;;;; SSSSccccrrrreeeeeeeennnn _s_c_r_e_e_n;;;; WWWWiiiinnnnddddoooowwww _w_i_n_d_o_w;;;; }}}}XXXXmmmmTTTTooooppppLLLLeeeevvvveeeellllLLLLeeeeaaaavvvveeeeCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt,,,, ****XXXXmmmmTTTTooooppppLLLLeeeevvvveeeellllLLLLeeeeaaaavvvveeeeCCCCaaaallllllllbbbbaaaacccckkkk;;;; _r_e_a_s_o_n Indicates why the callback was invoked. _e_v_e_n_t Points to the XXXXEEEEvvvveeeennnntttt that triggered the callback. _t_i_m_e_S_t_a_m_p Specifies the timestamp of the logical event. _s_c_r_e_e_n Specifies a screen associated with the top-level window or root window being left. _w_i_n_d_o_w Specifies the ID of the top-level window or root window being left. Page 19 (printed 4/30/98) XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmDDDDrrrraaaaggggCCCCoooonnnntttteeeexxxxtttt((((3333XXXX)))) TTTTrrrraaaannnnssssllllaaaattttiiiioooonnnnssss The XmDragContext translations are listed below. These translations may not directly correspond to a translation table. BBBBDDDDrrrraaaagggg MMMMoooottttiiiioooonnnn:::: DDDDrrrraaaaggggMMMMoooottttiiiioooonnnn(((()))) BBBBDDDDrrrraaaagggg RRRReeeelllleeeeaaaasssseeee:::: FFFFiiiinnnniiiisssshhhhDDDDrrrraaaagggg(((()))) KKKKCCCCaaaannnncccceeeellll:::: CCCCaaaannnncccceeeellllDDDDrrrraaaagggg(((()))) KKKKHHHHeeeellllpppp:::: HHHHeeeellllppppDDDDrrrraaaagggg(((()))) AAAAccccttttiiiioooonnnn RRRRoooouuuuttttiiiinnnneeeessss The XmDragContext action routines are described below: CCCCaaaannnncccceeeellllDDDDrrrraaaagggg(((()))): Cancels the drag operation and frees the associated DragContext. DDDDrrrraaaaggggMMMMoooottttiiiioooonnnn(((()))): Drags the selected data as the pointer is moved. FFFFiiiinnnniiiisssshhhhDDDDrrrraaaagggg(((()))): Finishes the drag operation and starts the drop operation. HHHHeeeellllppppDDDDrrrraaaagggg(((()))): Initiates a conditional drop that enables the receiver to provide help information to the user. The user can cancel or continue the drop operation in response to this information. VVVViiiirrrrttttuuuuaaaallll BBBBiiiinnnnddddiiiinnnnggggssss The bindings for virtual keys are vendor specific. For information about bindings for virtual buttons and keys, see VVVViiiirrrrttttuuuuaaaallllBBBBiiiinnnnddddiiiinnnnggggssss((((3333XXXX)))). RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN CCCCoooorrrreeee((((3333XXXX)))), XXXXmmmmDDDDiiiissssppppllllaaaayyyy((((3333XXXX)))), XXXXmmmmDDDDrrrraaaaggggCCCCaaaannnncccceeeellll((((3333XXXX)))), XXXXmmmmDDDDrrrraaaaggggIIIIccccoooonnnn((((3333XXXX)))), XXXXmmmmDDDDrrrraaaaggggSSSSttttaaaarrrrtttt((((3333XXXX)))), XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeee((((3333XXXX)))), XXXXmmmmDDDDrrrrooooppppTTTTrrrraaaannnnssssffffeeeerrrr((((3333XXXX)))), and XXXXmmmmSSSSccccrrrreeeeeeeennnn((((3333XXXX)))). Page 20 (printed 4/30/98)